Documentation: Correct references to properties.
authorMurray Cumming <murrayc@murrayc.com>
Wed, 15 Feb 2012 10:43:33 +0000 (11:43 +0100)
committerMurray Cumming <murrayc@murrayc.com>
Wed, 15 Feb 2012 10:43:33 +0000 (11:43 +0100)
These should use :, not ::, though signals would use ::.
See
http://developer.gnome.org/gtk-doc-manual/unstable/documenting_syntax.html.en
and
http://developer.gnome.org/gtk-doc-manual/unstable/documenting_symbols.html.en

15 files changed:
gtk/deprecated/gtkcolorsel.c
gtk/deprecated/gtkhbox.c
gtk/deprecated/gtkvbox.c
gtk/gtkactivatable.c
gtk/gtkactivatable.h
gtk/gtkappchooserbutton.c
gtk/gtkbbox.c
gtk/gtkcomboboxtext.c
gtk/gtkentry.c
gtk/gtkiconview.c
gtk/gtkoverlay.c
gtk/gtkprintoperation.c
gtk/gtkprintunixdialog.c
gtk/gtktoolitem.c
gtk/gtkwidget.c

index a0b8377192b799100414ec0eb66a6b2abd11b341..66b10189842a712809088364e8e7410bea329818 100644 (file)
@@ -3071,7 +3071,7 @@ gtk_color_selection_palette_to_string (const GdkColor *colors,
  * tries to modify the palette in a color selection.
  *
  * This function should save the new palette contents, and update
- * the #GtkSettings::gtk-color-palette GtkSettings property so all
+ * the #GtkSettings:gtk-color-palette GtkSettings property so all
  * GtkColorSelection widgets will be modified.
  *
  * Return value: the previous change palette hook (that was replaced)
index 0ebd000ef1a84efe8d61fe3200df93ee6f1e0531..3ea3253a30cb7dc12e6604109cc0b667dc414ddc 100644 (file)
@@ -49,7 +49,7 @@
  * very quick and easy change. If you have derived your own classes from
  * GtkHBox, you can simply change the inheritance to derive directly
  * from #GtkBox. No further changes are needed, since the default
- * value of the #GtkOrientable::orientation property is
+ * value of the #GtkOrientable:orientation property is
  * %GTK_ORIENTATION_HORIZONTAL.
  * If you want your code to be future-proof, the recommendation is to
  * switch to #GtkGrid, since #GtkBox is going to be deprecated in favor
index a74b53fceba9e0184bb98ac24ac5a02d24776b48..9105a8c28147593ee1bd525384a3fa2711dc395c 100644 (file)
@@ -49,7 +49,7 @@
  * GtkVBox has been deprecated. You can use #GtkBox instead, which is a
  * very quick and easy change. If you have derived your own classes from
  * GtkVBox, you can simply change the inheritance to derive directly
- * from #GtkBox, and set the #GtkOrientable::orientation property to
+ * from #GtkBox, and set the #GtkOrientable:orientation property to
  * %GTK_ORIENTATION_VERTICAL in your instance init function, with a
  * call like:
  * |[
index c22690ccb481d9b25b4faadb65f0edd521e5e792..9f659e061f59c5a30794cdef217ffecc5e5dbae3 100644 (file)
@@ -340,9 +340,9 @@ gtk_activatable_update (GtkActivatable *activatable,
  * @action: (allow-none): the related #GtkAction or %NULL
  *
  * This is called to update the activatable completely, this is called
- * internally when the #GtkActivatable::related-action property is set
+ * internally when the #GtkActivatable:related-action property is set
  * or unset and by the implementing class when
- * #GtkActivatable::use-action-appearance changes.
+ * #GtkActivatable:use-action-appearance changes.
  *
  * Since: 2.16
  **/
index 920b4a4eae7ca3a64ecfd59c673a839321f1592e..d713806a7ac8b0e0e2e553294fdce91a819be76a 100644 (file)
@@ -45,8 +45,8 @@ typedef struct _GtkActivatableIface GtkActivatableIface;
  * You must check the #GtkActivatable:use-action-appearance property only apply action
  * properties that are meant to effect the appearance accordingly.
  * @sync_action_properties: Called to update the activatable completely, this is called internally when
- * #GtkActivatable::related-action property is set or unset and by the implementor when
- * #GtkActivatable::use-action-appearance changes.<note><para>This method can be called
+ * #GtkActivatable:related-action property is set or unset and by the implementor when
+ * #GtkActivatable:use-action-appearance changes.<note><para>This method can be called
  * with a %NULL action at times</para></note>
  *
  * Since: 2.16
index bd1d335d3da2a27a5032ea739d8a457f662fb7fc..b49cf99f69a4ff4a62f434b1033ca455a65bc711 100644 (file)
  *
  * Initially, a #GtkAppChooserButton selects the first application
  * in its list, which will either be the most-recently used application
- * or, if #GtkAppChooserButton::show-default-item is %TRUE, the
+ * or, if #GtkAppChooserButton:show-default-item is %TRUE, the
  * default application.
  *
  * The list of applications shown in a #GtkAppChooserButton includes
  * the recommended applications for the given content type. When
- * #GtkAppChooserButton::show-default-item is set, the default application
+ * #GtkAppChooserButton:show-default-item is set, the default application
  * is also included. To let the user chooser other applications,
- * you can set the #GtkAppChooserButton::show-dialog-item property,
+ * you can set the #GtkAppChooserButton:show-dialog-item property,
  * which allows to open a full #GtkAppChooserDialog.
  *
  * It is possible to add custom items to the list, using
index bdecd58b658df66d97ee90395f26f18f5d19c387..69bab4131bb4e375fd7d149cf237c7d1689ebfd6 100644 (file)
  * same size. GtkButtonBox gives all children the same size, but it does allow
  * 'outliers' to keep their own larger size. To force all children to be
  * strictly the same size without exceptions, you can set the
- * #GtkButtonBox::homogeneous property to %TRUE.
+ * #GtkButtonBox:homogeneous property to %TRUE.
  *
  * To excempt individual children from homogeneous sizing regardless of their
- * 'outlier' status, you can set the #GtkButtonBox::non-homogeneous child
+ * 'outlier' status, you can set the #GtkButtonBox:non-homogeneous child
  * property.
  */
 
index f077c8e6fc74f451532f287185cbf3ca526a7aae..81bbd19b66d0e75e3afa15dcf8e647c88c7d38bc 100644 (file)
@@ -467,7 +467,7 @@ gtk_combo_box_text_prepend (GtkComboBoxText *combo_box,
  *
  * Inserts @text at @position in the list of strings stored in @combo_box.
  * If @id is non-%NULL then it is used as the ID of the row.  See
- * #GtkComboBox::id-column.
+ * #GtkComboBox:id-column.
  *
  * If @position is negative then @text is appended.
  *
index 552dfd6bbdcf5c2957fadfd95cf932587baa2321..d201affe8c5fa65f7872544ec4770dc2f9225145 100644 (file)
@@ -1392,7 +1392,7 @@ gtk_entry_class_init (GtkEntryClass *class)
    *
    * The invisible character is used when masking entry contents (in
    * \"password mode\")"). When it is not explicitly set with the
-   * #GtkEntry::invisible-char property, GTK+ determines the character
+   * #GtkEntry:invisible-char property, GTK+ determines the character
    * to use from a list of possible candidates, depending on availability
    * in the current font.
    *
index 57c2b1d130ab4941579479f05a5c2fad348f9277..49ac4a1eb9ed1eec8b524ced821718c871564d4d 100644 (file)
@@ -4494,7 +4494,7 @@ gtk_icon_view_set_tooltip_query_cb (GtkWidget  *widget,
  * for you. @column should be set to the column in @icon_view's model
  * containing the tooltip texts, or -1 to disable this feature.
  *
- * When enabled, #GtkWidget::has-tooltip will be set to %TRUE and
+ * When enabled, #GtkWidget:has-tooltip will be set to %TRUE and
  * @icon_view will connect a #GtkWidget::query-tooltip signal handler.
  *
  * Note that the signal handler sets the text with gtk_tooltip_set_markup(),
index b116ecb14444855bbe915d7664011a98c8ac32db..6f9cd3470a758e46414ed31766e3c34e063d56eb 100644 (file)
@@ -37,8 +37,8 @@
  *
  * GtkOverlay is a container which contains a single main child, on top
  * of which it can place <firstterm>overlay</firstterm> widgets. The
- * position of each overlay widget is determined by its #GtkWidget::halign
- * and #GtkWidget::valign properties. E.g. a widget with both alignments
+ * position of each overlay widget is determined by its #GtkWidget:halign
+ * and #GtkWidget:valign properties. E.g. a widget with both alignments
  * set to %GTK_ALIGN_START will be placed at the top left corner of the
  * main widget, whereas an overlay with halign set to %GTK_ALIGN_CENTER
  * and valign set to %GTK_ALIGN_END will be placed a the bottom edge of
@@ -605,7 +605,7 @@ gtk_overlay_new (void)
  * added with gtk_container_add().
  *
  * The position at which @widget is placed is determined
- * from its #GtkWidget::halign and #GtkWidget::valign properties.
+ * from its #GtkWidget:halign and #GtkWidget:valign properties.
  *
  * Since: 3.2
  */
index 87f4d4ebbde5a726a470666f9a0e0ee2249dc2b5..6150a1108eaf317c487ce1337884196e5a733468 100644 (file)
@@ -2420,7 +2420,7 @@ gtk_print_operation_set_embed_page_setup (GtkPrintOperation  *op,
  * gtk_print_operation_get_embed_page_setup:
  * @op: a #GtkPrintOperation
  *
- * Gets the value of #GtkPrintOperation::embed-page-setup property.
+ * Gets the value of #GtkPrintOperation:embed-page-setup property.
  * 
  * Returns: whether page setup selection combos are embedded
  *
@@ -3305,7 +3305,7 @@ gtk_print_operation_set_support_selection (GtkPrintOperation  *op,
  * gtk_print_operation_get_support_selection:
  * @op: a #GtkPrintOperation
  *
- * Gets the value of #GtkPrintOperation::support-selection property.
+ * Gets the value of #GtkPrintOperation:support-selection property.
  * 
  * Returns: whether the application supports print of selection
  *
@@ -3354,7 +3354,7 @@ gtk_print_operation_set_has_selection (GtkPrintOperation  *op,
  * gtk_print_operation_get_has_selection:
  * @op: a #GtkPrintOperation
  *
- * Gets the value of #GtkPrintOperation::has-selection property.
+ * Gets the value of #GtkPrintOperation:has-selection property.
  * 
  * Returns: whether there is a selection
  *
index 44b0fdcb3944b2165a20c5609973eb83de84d5e9..3c5320f8a98fe979276f3cc63b872d6420991ea4 100644 (file)
@@ -4272,7 +4272,7 @@ gtk_print_unix_dialog_set_manual_capabilities (GtkPrintUnixDialog   *dialog,
  * gtk_print_unix_dialog_get_manual_capabilities:
  * @dialog: a #GtkPrintUnixDialog
  *
- * Gets the value of #GtkPrintUnixDialog::manual-capabilities property.
+ * Gets the value of #GtkPrintUnixDialog:manual-capabilities property.
  *
  * Returns: the printing capabilities
  *
@@ -4332,7 +4332,7 @@ gtk_print_unix_dialog_set_support_selection (GtkPrintUnixDialog *dialog,
  * gtk_print_unix_dialog_get_support_selection:
  * @dialog: a #GtkPrintUnixDialog
  *
- * Gets the value of #GtkPrintUnixDialog::support-selection property.
+ * Gets the value of #GtkPrintUnixDialog:support-selection property.
  *
  * Returns: whether the application supports print of selection
  *
@@ -4386,7 +4386,7 @@ gtk_print_unix_dialog_set_has_selection (GtkPrintUnixDialog *dialog,
  * gtk_print_unix_dialog_get_has_selection:
  * @dialog: a #GtkPrintUnixDialog
  *
- * Gets the value of #GtkPrintUnixDialog::has-selection property.
+ * Gets the value of #GtkPrintUnixDialog:has-selection property.
  *
  * Returns: whether there is a selection
  *
@@ -4454,7 +4454,7 @@ gtk_print_unix_dialog_set_embed_page_setup (GtkPrintUnixDialog *dialog,
  * gtk_print_unix_dialog_get_embed_page_setup:
  * @dialog: a #GtkPrintUnixDialog
  *
- * Gets the value of #GtkPrintUnixDialog::embed-page-setup property.
+ * Gets the value of #GtkPrintUnixDialog:embed-page-setup property.
  *
  * Returns: whether there is a selection
  *
index 213fc820937f26c2f5fca52a8c193b67dff2ba82..dd1b60e5678e7908e4c7bd0582460ba5f4549688 100644 (file)
@@ -788,7 +788,7 @@ gtk_tool_item_get_orientation (GtkToolItem *tool_item)
  * show text</listitem>
  * <listitem> GTK_TOOLBAR_BOTH_HORIZ, meaning the tool item should show
  * both an icon and a label, arranged horizontally (however, note the 
- * #GtkToolButton::has_text_horizontally that makes tool buttons not
+ * #GtkToolButton:has_text_horizontally property that makes tool buttons not
  * show labels when the toolbar style is GTK_TOOLBAR_BOTH_HORIZ.
  * </listitem>
  * </itemizedlist>
index 0e4d1985eafbf4a64be31c0f31c6c63b094d9d02..96dd94e1f4aa35243c365705107cfe4a6a694bfa 100644 (file)
@@ -1494,7 +1494,7 @@ gtk_widget_class_init (GtkWidgetClass *klass)
    * The ::state-changed signal is emitted when the widget state changes.
    * See gtk_widget_get_state().
    *
-   * Deprecated: 3.0. Use #GtkWidget::state-flags-changed instead.
+   * Deprecated: 3.0. Use #GtkWidget:state-flags-changed instead.
    */
   widget_signals[STATE_CHANGED] =
     g_signal_new (I_("state-changed"),